GetDragAttributes

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODDragAndDrop

GetDragAttributes
The GetDragAttributes method returns additional information about the current drag-and-drop operation.
ODULong GetDragAttributes ();
return value
A 32-bit value consisting of flags that specify attributes of the current drag operation.

DISCUSSION
If no drag operation is in progress, the returned value is zero. Otherwise, the bit flags are set in the returned value to indicate attributes of the operation. For example, the kODDragIsInSourcePart flag is set if the drag has not left the source part; the kODDropIsMove flag is set if the drag items are being moved (not copied).
If a drag enters your part, or a drop occurs in your part, you can call this method to determine how your part should respond.

If your part is tracking a drag that has entered one of its facets, you can decide whether to provide the user visual feedback by checking whether the kODDragIsInSourcePart or kODDragIsInSourceFrame flags are set in the returned value.
If a drop occurred in your part, you can determine the appropriate response by checking which of the drop flags (for example, kODDropIsMove or kODDropIsCopy) are set in the returned value.

EXCEPTIONS

kODErrNoDragManager
No platform-specific drag system service is available.

SEE ALSO
"Drag Attributes" on page 921.
"Drag Attributes and the Drop Method" on page 364 in OpenDoc Programmer's Guide.